home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 February / EnigmA AMIGA RUN 34 (1999)(G.R. Edizioni)(IT)[!][issue 1999-02].iso / www / amitrix / awebdl.lha / AWebDL.doc < prev    next >
Text File  |  1998-01-27  |  4KB  |  130 lines
  1. NAME
  2.    AWebDL
  3.  
  4.  
  5. VERSION
  6.    2.1 (15.12.97)
  7.  
  8.  
  9. AUTHOR
  10.    Gabriele Favrin (favrin@tin.it)
  11.  
  12.  
  13. REQUIREMENTS AND DISTRIBUTION
  14.    Requires AWeb 3.0 or higher.
  15.  
  16.    AWebDL is freeware, not public domain. It may be spread only in
  17.    unmodified form. Commercial utilization of this package is exclusively
  18.    allowed to AmiTrix and Yvon Rozijn (AWeb author).
  19.  
  20.  
  21. LEGAL THINGS
  22.    The author is in no way responsible for moral and/or material damages that
  23.    his program may cause to people or things. The programmer gave his best
  24.    to limit the problems that this tool may cause, but he is not able to
  25.    guarantee its efficiency in all situations. Using this program, you
  26.    the user, are responsible for all moral, material, civil and penal things.
  27.  
  28.  
  29. WHAT DOES IT DO?
  30.    This program allows you to download/save images and/or files avoiding the
  31.    requester that AWeb usually displays. This is especially useful when
  32.    downloading files from Aminet and other file archives.
  33.  
  34.    Features:
  35.  
  36.    o allows to set different dir for images and links (html or files).
  37.    o automated duplicate check and rename of new file or display of a
  38.      requester with options to change name (manually or automatically),
  39.      overwrite or append over an existing file,
  40.    o striping of illegal AmigaDOS characters from filename.
  41.    o optional creation of a log file with file names, url and date of
  42.      download.
  43.  
  44.  
  45. INSTALLATION
  46.    o Copy AWebDL.awebrx in the AWeb's Plugins directory
  47.  
  48.    o Add to Settings/GUI/Popup/Image and Settings/GUI/Popup/Link
  49.      both if object is or isn't in memory.
  50.  
  51.      Title:   AWebDL
  52.      Command:
  53.      RUN AWeb3:Plugins/AWebDL.awebrx savedir="save_directory" url="%u"
  54.  
  55.      Note that the AWeb3: assign (which points to the AWeb directory) is
  56.      created by the AWeb installation procedure and needed by various
  57.      plugins, other than by update scripts.
  58.  
  59.      Remember to put argouments in double quotes!
  60.  
  61.      You may specify different options (for example different save
  62.      directories for images and files) in the two lines that have to be
  63.      added in the settings (one for image popup and the other for the link
  64.      one).
  65.  
  66.      A little explanation of default and optional argouments:
  67.  
  68.      savedir=
  69.      This argoument should contain the save directory.
  70.  
  71.      url="%u"
  72.      Nothing to say. It's the url. Must be double quoted. AWeb knows what
  73.      to put over the %u.
  74.  
  75.      log=
  76.      Setting a path for the log file enables use of it. Log file contains
  77.      informations about your downloaded files: their url, name of the saved
  78.      file and date. Put the log on hard disk, not in the ram. Log can't
  79.      track informations in case of failure (see "limitations").
  80.  
  81.      req=
  82.      If the file to save already exists, AWebDL can automatically search
  83.      a new name (req=0 or avoid the option) or display a requester like
  84.      the one used by AWeb in such cases (req=1). The requester allows to
  85.      overwrite the old file, append data to it (not a good idea if file isn't
  86.      a text!), choose a new name or tell AWebDL to search for a new name.
  87.  
  88.    o To change directories in the future you can edit the ENVARC:AWeb3/GUI
  89.      file or use Settings/GUI menu from AWeb as described above.
  90.  
  91.  
  92. USAGE
  93.    Simply open popup menu for the object (file or image) you want to save and
  94.    choose the AWebDL option.
  95.  
  96.  
  97. LIMITATIONS
  98.    If a timeout or other problem happens while downloading file, AWeb
  99.    displays its "incomplete file" requester. Choosing "Retry" the old
  100.    requester is showed and download is done WITHOUT using AWebDL, so maybe
  101.    in another directory and with different name.
  102.  
  103.  
  104. FUTURE
  105.    Any suggestion, bug reports or criticism is welcome! Write me at:
  106.  
  107.    E-Mail:   favrin@tin.it
  108.    FidoNet:  2:333/726.8
  109.  
  110.    Please write in italian or english, thank you.
  111.  
  112.    Visit my Home Page:
  113.    http://freepage.logicom.it/personal/poing/
  114.  
  115.  
  116. GREETINGS
  117.    Thanks to Bill Parker for spell checking of this document and beta test of
  118.    the program.
  119.  
  120.  
  121. CHILDWARE
  122.    This software is "CHILDWARE". The author explicitly asks whoever uses this
  123.    program to make a donation toward a beneficial corporate body which works
  124.    in help of the children, in any form or way.
  125.  
  126.    If you don't know any, ask your local post office and inform yourself on
  127.    how to make a payment to The UNICEF.
  128.  
  129.    The amount of the offer is up to you , but please do it!
  130.